Micron Document
ouroboros git

Node / public / FreeDVInterface rns://4cf8a0651c4d73cacd0f93ac1d95e80a/public/FreeDVInterface


-─
FreeDVInterface
-
This is a CustomInterface for Reticulum that provides a plug and play, cross-platform sound modem interface for HF radios using the FreeDV API.
It supports VOX, serial, and Hamilb PTT. The interface also provides highly configurable options for collision avoidance.

⚠ Work in progress

Supported modes:

┌───────────┬───────────────────┬──────────────────────────┬─────────────────────┐
│ Mode name │ RF bandwidth (Hz) │ Payload data rate bits/s │ Payload bytes/frame │
├───────────┼───────────────────┼──────────────────────────┼─────────────────────┤
│ datac1 │ 1700 │ 980 │ 510 │
└───────────┴───────────────────┴──────────────────────────┴─────────────────────┘

From https://github.com/drowe67/codec2/blob/main/README_data.md

Setup:
-

Raspberry Pi (Zero, 4, 5) / Debian / Ubuntu


1. Build and install codec2:
T282828
sudo apt install git build-essential cmake
git clone https://github.com/drowe67/codec2
cd codec2
mkdir build_linux
cd build_linux
cmake ..
make

2. Install pre-requisites
T282828
sudo apt install portaudio19-dev
pip install pyaudio OR sudo apt install python-pyaudio
pip install numpy OR sudo apt install python-numpy

3. (Optional) install Hamlib for rigctl PTT support
T282828
sudo apt install libhamlib-utils

4. Move FreeDVInterface.py to the "interfaces" folder in your Reticulum install location
T282828
git clone https://github.com/RFnexus/FreeDVInterface.git
cd FreeDVInterface
mv FreeDVInterface.py ~/.reticulum/interfaces
5. Add a FreeDVInterface to your Reticulum config

An example config looks like this. Here we are using T383838rigctld to key on / off the PTT on a ICOM-7300.

T282828
[[FreeDVInterface IC-7300]]
type = FreeDVInterface
interface_enabled = True
input_device = default # String or device number
output_device = default # String or device number
freedv_mode = datac1
tx_volume = 100
ptt_type = hamlib
hamlib_network = True
hamlib_host = localhost
hamlib_port = 4532
csma_enabled = True

Windows

T383838TODO

Fedora

T383838TODO


Troubleshooting
│ I keep seeing "Invalid sample rate"

Ensure that you have the right audio devices configured

│ I'm using a single board computer like the Raspberry Pi Zero and keep seeing "ALSA lib
│ pcm.c:8526:(sendpcmrecover) underrun occured"

Ensure that your Pi / other SBC is getting enough power and that there are no issues with the USB soundcard or other USB device connected to your radio




Served by rngit 1.2.7 - Generated in 0.04s